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INTRODUCTION 

1. WHAT IS BOOKI? 

2. WHAT CAN I USE BOOKI FOR? 
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WHAT IS BOOKI? 



With Booki you can create Books. Real paper books that look good and you can hold in your 
hands. You can also use Booki to produce books in the form of epub (electronic books), PDF, 
Word Processing files, web pages and more... 

Booki is designed to help you produce books, either by yourself or with others. Booki is also a 
modern social environment where you can also discuss your views about producing books, 
seek assistance from others, look for projects to contribute to, seek others to help you, 
translate content and publish completed works. 

Booki also supports the rapid development of content. You can use Booki to develop content 
in intensive 'Book Sprints'. Book Sprints are intensive collaborative events where 6-20 people 
focus on writing a book in 2-5 days. These collaborators might be in the same room or located 
around the net, in either case they work together simultaneously to produce a book rapidly. 

While you can use Booki to support very traditional book authoring processes, Booki was also 
developed to facilitate the accelerated production models enabled by Book Sprints. Hence the 
feature set matches the rapid pace of publishing possible in the modern era of print on 
demand. Using Booki, a book can be created in 2-5 days and then print ready source (book 
formatted PDF) can be generated in another 2-5 minutes, and then uploaded to your favorite 
Print on Demand service. 

Booki is Free Software (GPL 2+) and developed by FLOSS Manuals. 
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WHAT CAN I USE BOOKI FOR? 



Booki supports any individual or group that wishes to write a book. Some typical uses of the 
platform might be : 

• Writing books - e.g. a Manual, a Cook Book, a Book about Fishing, a fictional tale. 

• Producing printed books 

• Producing ebooks 

• Writing any content as an individual. 

• Collaboratively authoring content. 

• Rapidly developing content in Book Sprints. 

• Customising existing content to apply to a very specific context. 

• Translating a book into another language. 

SIMPLE USE CASES 

Book Sprint 

I am working for rights of immigrant workers. We need to create a booklet about workers 
rights. I read the (free) FLOSS Manuals online manual on Book Sprints and then organise 5 staff 
to dedicate 3 consecutive days the following week. The first morning we each create an 
account. I have already created the new book, given it an open license, sent the others the 
URL, and prepared the Index. We spend 3 hours discussing the chapters and decide who will 
write what. At lunch on the first day we start writing. We continue to write for the following 2 
days. At the end of the last day we output an A5 book formatted PDF of 110 pages and take 
it to our local printer to make 500 stapled copies. Over the next 2 days peers from other 
offices log in to improve and build upon our work. We make the book formatted PDF freely 
available from our website to read or to print for distribution. Each of the other offices print 
copies locally and distributes them. 

Customising Content 

I am a developer that has contributed to several manuals on Free Software. My specialty is 
Drupal, and I have a client that I have just created a site for using Drupal. I want to create a 
manual for that client so I go to my user page and fork the existing FLOSS Manuals Groups 
manual on Drupal. I now have a standalone version of the manual on my account, any 
alterations I do will not be reflected in the original manual unless I merge the changes up 
stream. I remove several chapters not relevant to the client, add 4 new chapters that are 
specific to the client. I mark the new chapters as a€ceCopyright : all rights reserveda€ and 
private so they are not reusable or seen by anyone else using the system. I write these 
chapters with information that is specific to my client and replace several existing screen 
shots in other chapters with screenshots of my clients site. I export the material to book 
formatted PDF, upload it to lulu.com print on demand service and buy 2 copies of the perfect 
bound book for my client. Later a potential client calls me for a meeting - I use my version of 
the Drupal manual, remove the client sensitive material, upload it, buy it, and bring the book 
to the meeting. 

Translating 



I am a volunteer translator. I want to translate a book on Mexican Cooking from the CookMe 
Group into French. I fork the existing manual from the CookMe Group to my user page. I force 
a machine translation of the content and mark all chapters a€ceto be translateda€. I message 
others subscribed to the Booki French group that I need some help and with 3 others we 
translate the material and mark all the chapters a€ceto be proofeda€ or a€oerequires 
technical proofingaC as we complete them. When we are finished I invite a friend to proof the 
content for us. She takes 1 week, doing it in her spare time. After each chapter is proofed she 
marks them a€oecompletea€. Later I output the translated book to book formatted PDF, 
upload to lulu.com and buy a copy. 

Multiple Formats 

I am an educator and have written a text book on digital design using Booki. While writing I 
kept the book private but invited select users to view the material and leave comments a€" 
this was great feedback for me. Now the book is completed and has been picked up by a 
publisher a€" I output an .odt file from Booki and open this in OpenOffice.org, save to a .doc 
format (the publisher does not know about free software) and send to them. I also negotiated 
a Creative Commons license for the material with the publisher. I release the book on my 
website using the embed api and invite translations. Within 4 weeks there is a completed 
Spanish translation which is uploaded to a print on demand service and sold through my 
website. A Portuguese translation is ready 3 weeks later. After an enthusiastic response to 
the Portuguese translation in Brazil I output the material to multiple column PDF suitable for 
printing on large format newsprint. A school district in Sao Paolo finds a local printer, 
downloads the PDF for free, and produces 1500 copies on newsprint and distributes for free 
around schools a€" this costs the same as printing or buying 30 printed books so I feel good 
and the schools make a huge savings. 

Portability 

I am invited to facilitate a Book Sprint on farming techniques in a remote area. The venue is a 
farm with no internet connectivity. I know a little about how to install web services so I 
download and install Booki on my laptop. At the Book Sprint we have 4 laptops connected to 
the local network version of Booki running on my machine. We write the book in 5 days. We 
output the book formatted PDF from my laptop, print the book at a local printer and 
distribute locally as educational materials. Later I upload the sources to the version of Booki 
running on my own server so others can access and reuse the content as they please. 

Organisational Documentation 

My organisation wants to review and upgrade it's documentation. We have decided to use 
Booki to collaboratively rewrite and update our content. Our IT Guru has installed Booki on our 
server so writers can login and update documentation from any machine. We will use the 
versioning feature to keep track of documentation versions as our docs grow and develop 
over time. When final revisions have been approved they are 'published' to screen readable 
PDF and Book Formatted PDF. The Book Formatted PDF is printed off for our 'official 
documentation' while the Screen readable PDF stored on our server for easy digital access by 
staff. 
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ACCESSING BOOKI 



Booki can be accessed in several ways: 

• Firstly, the Booki web page provides hosting for many groups and books and is found at 
http://www. booki. cc. 

• Your organisation may have installed a copy of Booki on their own server. In this case 
access would be made through a url provided by your organisation. 

• Like in the Portability use case outlined in the 'How can I use Booki?" chapter, you 
may have Booki installed on your own computer. In this case you would use the url 
created when you installed Booki. 

Fig: The Booki Home Page 

Once you have arrived the home page, most functions can be accessed via the Menu down 
the left hand side of the window. 

m 

Fig: The Booki Menu 
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NAVIGATING BOOKI 



Navigation around Booki is pretty easy, on the left hand side of the web page is the menu, 
this is used to access most areas of Booki. When reading a book, there is a table of contents 
running down the left hand side of the reading pane which is used to navigate between 
chapters. 

MENU TOOL-BAR 

& 

About - This is booki's home page 

Books - This link takes you to a List of all books created and stored on the Booki server. 
From here you can click on any book title for reading or editing. 

Groups - This link takes you to a list of all the groups that have been created. From this list 
you can link to the Group-page for any group where you can see a list of all the members of 
the group and all the books that have been added to that group. 

People - Displays a page listing all the people signed up with Booki. Clicking on a person's 
name will take you to their profile page. 

My Profile - loads a page displaying your profile, here you will see lists of books you have 
created or imported, groups you are a member of as well as areas where you can create or 
import new books and create new groups. 

My Settings - Displays a page where you can alter your user settings 

My Books - Loads a list of all the books you have created from scratch or imported. 

My Groups - Displays a list of all the groups you have joined. 



--need to add more-- 
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READING A BOOK 



Reading a book that has been created, imported or edited with booki is easy. You don't need 
to create an account to read a book, just follow these simple steps. 

1. Go to the Booki home page www.booki.ee. 

2. Click on Books in the menu running down the left-hand side of the page. 



3. Click on the title that you would like to read. 

o you are taken to the reading screen for the book. 

4. A list of chapters runs down the side of panel, click on the chapter you want to read. 

o the chapter loads into the main panel of the screen for you to read. 

Because the list of books on the Books page is large, it could be easier to click on Groups 
from the menu and then choose a group from the Groups-list. Finally pick the book you want 
from the Books list on the Group page. 



H 



USE CASE 

e.g. You are a fan of classic English literature, recently you heard from a friend that a lot of 
literature with expired copyright has been added to Booki by the English Literature group. 
Always in search of a good read, you navigate to www.booki.cc.and once there you click on 
Groups. When the Groups-list is displayed you click on the English Literature group, taking you 
to their Group page. You browse their Book List and notice that they include Alice's 
Adventures in Wonderland. As this was a childhood favourite of yours you click on the Books 
title taking you to it's reading page, you click on Chapter I - Down the Rabbit Hole and start 
reading. 

m l 
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CREATING AN ACCOUNT 



After arriving at Booki you will need to create a user account before beginning the creation 
and editing of books. 

Account generation is simple: 

1. On the front page click on Login / Register at the top of the screen. 

2. Under Registration add your desired username, email, password + confirmation and 
then your full name. 

o Your full name is required for registration as it is used for copyright attribution on 
any works you create or contribute to. 

3. click 'Register'. 

4. Booki will generate the account and log you into your User Page. Your user page is also 
accessed through My Profile on the menu. 

USE CASE 

You are a keen gardener and have a lot of knowledge to share, hearing of Booki you decide to 
create an account and write books about gardening. Upon accessing the Booki home page 
you click on the Login / Register link and fill in your Username, E-Mail, Passwords and Full 
Name before clicking Register to complete the process. You are now able to create, import, 
edit and contribute to books on Booki. 
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7. 



MY SETTINGS 



Once you have created and account, you can edit your settings, to customise your 
appearance on Booki and to help communication with the members of any groups you may be 
a part of. To view your settings click My Settings on the menu. 

<insert pic of my setings> 

When you first enter this page you will see a generic image in the top left corner along with 
the email and full name you entered when creating your account. 

On the right hand side of the panel you can edit your email and full name if either of those 
were typed in incorrectly or if they change in the future. 

Below your full name is a text box where you can type in a blurb about yourself, and at the 
bottom of the page you can browse your computer for an image to upload for Booki for use in 
your profile. 



Once you have made the changes you want to your settings click Save user profile to save 
your changes. 

The last user setting you can change is found on the My Profile page. Once the page has 
been loaded you will see in the top right hand corner of the page a text box asking What's on 
your mind ? You can click in this box and add any comment about how you are feeling and 
what you are thinking about, then click on Share to save the comment. This now appears 
under your full name on your My Profile page. 
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8. 



JOINING A GROUP 



After joining Booki you may want to jump right in and create a book that will be listed under 
your name. However, Booki has the ability to organise groups together to create books that 
share a common theme or interest. 

One example of a Group would be an Organic Gardening group, the group was formed to write 
books about different aspects of organic gardening.encouraging people to start their own 
organic gardens. Organic Gardeners have joined the group to help contribute their expertise in 
the creation of these books. A selection of titles created by the group may include: Growing 
Vegetables, Creating Your Garden, Composting, Growing Fruit Trees, Pest Control and 
Ornamental Gardens. 

To Join a Group: 

1. Click on Groups in the menu. 

2. Find the group you want to join in the Groups-list and click on it. 

3. On the Group page click on the JOIN THIS GROUP button at the bottom of the main 
panel. 

4. You are added to the group and will see your name appear under the Members list. 

REMOVING YOURSELF FROM A GROUP 

At some point you may want to remove yourself from a group. 

1. Go to the Booki home page and click on the link to the Group that you want to be 
removed from. 

o You can also find the Group from your User Page, it will be included in the Group 
list. 

2. On the Group page click on REMOVE ME FROM THIS GROUP. 

o You will be removed from the group and your name will disappear from the 
Members list. 

CASE USE 

As an experienced gardener you have recently heard about Booki and the Organic Gardening 
group through a blog page on a gardening website. You have accessed the Booki web page 
and just finished creating your account and now want to join the Organic Gardening group. 

1. You click on the Groups link in the menu taking you to the Groups-list. 

2. On the Groups-list page, you find the Organic Gardening group and click on its link. 

3. This takes you to the Organic Gardening group page, you click on JOIN THIS GROUP and 
see your name added to the Members list. 
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9. 



CREATING A GROUP 



Sometimes the group you want to join isn't there yet, so this is your opportunity to blaze a 
trail and start up a group of your very own. 

1. Click on My Profile in the menu 

• Once the page loads you will see the bottom right section of the page is labelled Create 
new group. 




• In the Group name box type in a name for your group and then type in a brief description 
in the What is this group about box below. 

• Be sure that you have everything entered as you want it as currently Booki doesn't let 
you change your settings once the group has been created. 

• Finally click on the Create new group button at the bottom of the page. 

• Your new group will be added to the Groups list on your page and you can click on it to 
take you to the group page. 

USE CASE 

You are a primary school teacher and for a class project you want your students to work 
together creating a Book outlining the results of their research. Your hope is that the finished 
document will able to be used as a learning resource for future classes. To ensure that only 
your class are the editors you decide to create a group that the class will use for their 
project. You log in to Booki and click My Profile in the menu. You enter "Room 4 Class 
Projects" into the Group name text box and then type in "Students from room 4 at Sildale 
Primary School use this group to create Books based on class projects." into the What this 
group is about text area. After clicking Create new group you see the group is now added 
to your groups list. You finally click on the group name "Room 4 Class Projects " which takes 
you to the group page. 

■ 
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10. 



CREATING A BOOK 



There are two ways to create a project in Booki. The first is to create a new blank book and 
the second is to import a book from Archive.org, WikiBooks or any epub file. In this chapter 
we will look at creating a new blank book and then explore importing books in the following 
chapter. 

Once a user has created an account they can manage the creation of books from their user 
page. This is as simple as entering the title of the book in the field provided and then choosing 
the desired license from the drop down menu. 

H 

1. Click on My Profile in the Menu to go to your user page. 

2. Under Create new book enter the title for your Book and then select the Licence for 
the book from the Drop-down list. 

o For more info on licences and which ones to use when - see the chapter on 
Licensing. 

3. Once you press Create, the book will then be generated and listed under the Books 
heading on your user page. The book has by default no chapters, sections, or content. 

Note: If you try to create a book with the same title as a book that has already exists then 
booki will add '-/' to the end of the title and try again, then if the new title also already exists 
it will try '-2'... '-3'... and so on, until it finds a title that has not yet been created. 

USE CASE 

As an organic gardener you have had a lot of experience growing grapes. After joining the 
Organic Gardening Group you decide to start a book based on your particular experience. You 
access your User page via My Profile in the Menu and once the page has loaded you type in 
the title "Growing Vine Fruit " under Create New Book. Because you are passionate about 
organic gardening and want as many resources as possible to be available for people who want 
start organic gardening you decide to use the Creative Commons CC-BY-SA licence. This 
licence allows anyone else to use the text in the book, either just to copy or for use in their 
own creation (for example another book on organic gardening), so long as they cite your book 
as the source of any material used and they also use the CC-BY-SA licence on any works they 
create using material from your book. You now click Create and complete the generation of 
your first book! 
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IMPORTING A BOOK 



Books can be imported from several sources, Archive.org, WikiBooks, and epub files. In 
this chapter we go through each of these scenarios. 

Note: When importing text into Booki from it's respective locations and formats it is important 
to note that the document structure may not be a part of the source file. This would leave 
the entire text in a single chapter which will need to be broken up into its individual chapters 
and Sections once in Booki. 

Note: If you try to create a book with the same title as a book that has already exists then 
Booki will add '-/' to the end of the title and try again, then if the new title also already exists 
it will try '-2'... '-3'... and so on, until it finds a title that has not yet been created. 

ARCHIVE.ORG 

The Internet Archive is a a non-profit digital library storing digitised collections of websites, 
music, moving images, software and books. With its stated mission of "universal access to all 
knowledge ." , its purposes include offering permanent access for researchers, historians, 
scholars, people with disabilities, and the general public to historical collections that exist in 
digital format. 

On your My Profile page under Import from Archive.org enter the Archive id and press 
Import. 

• The Archive id can be found in the Identifier field under the Selected metadata 
section at the bottom of the text's page on Archive.org. 

The text is now imported from Archive.org using Espri and converted into a Booki-zip file (this 
may take a while). Once the process has finished the imported book will be added to the list 
of books on your My Profile page. 

EPUB DOCUMENT 

ePub, short for Electronic Publication is an open standard e-book format, that has the ability 
to optimise the text display for whichever device is viewing the book. Booki has the ability to 
import any document in ePub format (note: although ePub is an open format, not all books 
available in ePub format have open licences so care needs to be taken when choosing to 
import an ePub document that it contains a permissive copyright). 

To import an ePub document, first you need to get the url for the ePub book, then copy it's 
location. 

• On your User page in Booki, paste the ePub url into the Url field under Import epub and 
click Import. 

The text is now imported using Espri and converted into a Booki-zip file (this may take a 
while). Once the process has finished the imported book will be added to the list of books on 
your My Profile page. 

USE CASE 

Archive.org 
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You have recently joined the Organic Gardening group and have gone in search for already 
compiled texts that could be used to booster the number books available under Organic 
Gardening. Searching through Archive.org you find a book on gardening from 1847, entitled 
"The Family Kitchen Gardener" by Robert Buist. Due to it's age, you have a suspicion that it 
may pre-date all the chemical methods employed by modern conventional gardening and 
therefore contain natural organic methods for growing edible plants. A brief read confirms this 
suspicion and also reveals that there are areas of the text that could do with tidying up as 
well as some updating for the 21st Century, cementing it as a great candidate for importing to 
Booki. 

1. You navigate to The Family Kitchen Gardener 's page on Archive.org 
(http://www.archive.org/details/RobertBuiststheFamilyKitchenGardener1847) 

2. You scroll down to the bottom of the page where you find the section called Selected 
metadata. 

3. Here you can see that the Identifyer is: RobertBuiststheFamilyKitchenGardener1847. You 
copy the Identifier and then go to your My Profile page on Booki. 

4. Under Import from archive.org you paste the Identifier into the Archive id field and 
click on Import. 

5. Booki takes a couple of minutes importing the book and when it is finished you see The 
Family Kitchen Gardener listed under Books on you My Profile page. 

6. You can now click on it's title in the Books list to start reading. 

ePub document 

After importing The Family Kitchen Gardener you have been looking through Project Gutenberg 
(www.gutenberg.org) and have found a book entitled "Culinary Herbs: Their Cultivation 
Harvesting Curing and Uses" by M. G. Kains Originally published in 1912 it contains a lot of 
information not only around growing herbs, but also ways to treat, store and use them and 
provides a fantastic base for a book on organically growing herbs. 

1. After loading your Profile page in Booki, you open a new tab or window in your web 
browser. 

2. In the new Tab/Window you navigate to the home page for Culinary Herbs: Their 
Cultivation Harvesting Curing and Uses (http://www.gutenberg.org/ebooks/21414) 

3. Once here you scroll down to the Download this ebook for free section of the page. 
Under the Computer-generated files list you see two epub versions of the book one with 
pictures and one that is plain text. 

4. Thinking that it would be easier to remove any unneeded or unwanted pictures than to 
add new ones later on, you decide to import the version with pictures. You right-click 
on the main site link in the EPUB with images row of the list and click on copy link 
location (firefox, ...) or... (ie, ...), or... (safari, ...). 

5. Going back to the tab/window containing your profile page you paste the copied link into 
the url textbox under Import epub, then click on Import 

6. Booki takes a couple of minutes importing the book and when it is finished you see 
Culinary Herbs: Their Cultivation Harvesting Curing and Uses listed under Books on you 
My Profile page. 

7. You can now click on the edit link next to it's title in the Books list to start editing the 
newly imported book. 
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ADDING A BOOK TO A GROUP 



Once you have created or imported a book into Booki, it will sit in the Books list on your user 
page. As a member of a group often you will want the book that has been created to sit in 
the Group's list of books as well. 

e.g. as an organic gardener with a lot of experience growing grapes, you have just created a 
new book called Growing Vine Fruit. You now want to add this book to the Organic Gardening 
group, not only will it help end readers to find the book, but it will also encourage collaboration 
from other members of the Organic Gardening group with experience growing vine fruit. 

1. On your User page, click on the Organic Gardening link in the Groups list. 

o You can also use the Groups list on the Booki home page to access the link. 

2. Once the Organic Gardening group page has loaded you will see a drop-down list 
containing the titles of books that you have either imported or created. 

3. Click on the list and select the book you want to add to the Group 

o In this case it would be Growing Vine Fruit 

4. Now click ADD THIS BOOK TO GROUP 

o Your book now appears under the Books list on the Group page. 

REMOVING A BOOK FROM A GROUP 

At some point you may want to remove a book from a group. On the group's page under the 
Books list you will see a remove link next to your book. Click on the link and your book will 
disappear from the list. 
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13. 



CREATING A CHAPTER 



Once a new book is created click on the 'edit' link on your User page to open the books Table 
of contents page. 

• to add a chapter to a book someone else has created, return to the Booki home page, 
click on the book you want to add a chapter to and then click on the 'EDIT' link. 

On the editing page click on the 'NEW CHAPTER' link to add a chapter. The New chapter 
window opens, enter your new chapter title and click 'Create chapter'. 

The new chapter is created in the Hold chapters section of your editing page. 
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14. 



EDITING A CHAPTER 



To create content for or to edit a chapter click on the 'EDIT' link next to the chapter title on 
the Table of contents page. 

The text editor opens showing the Chapter Title and any content that has already been 
added. Enter your content into the editor using the toolbar buttons when needed to format 
the font, add lists, tables, links and images. 

Clicking 'Save and continue editing ' allows you to quickly save your changes and continue 
editing the chapter. Clicking on 'Save' will save your changes and then take you back to the 
editing page. 'Cancel' removes any changes you have made and returns you to the editing 
page. 

To change the title of your chapter, double click on the title in the Table of contents page. 
You can now edit your chapter title. Click on 'Save' to keep the changes or Cancel' to reject 
them. 
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CREATING AND EDITING THE INDEX 



Once several chapters have been created and developed, it is time to organise and order your 
Table of Contents. 

On the Table of contents page your newly created chapters will be sitting under the Hold 
chapters section, but before you add your chapters to the Table of contents, you may want 
to create separate sections for these chapters to sit under. The sections could have titles 
such as Introduction, Advanced Features, Appendix, or whatever best suits your content. 

To create a new section, click on the 'NEW SECTION' link. A window opens where you enter 
your new section's title and click Create section', the new section will now be sitting under 
the Table of contents area of your page. Use the above steps to create any other sections 
that you require. If your sections need to be re-ordered click on the up/down arrow at the 
left of the Section bar you wish to move and drag the section into it's rightful place. If you 
need to delete a section, drag it into the Hold chapters area of the Table of Contents page. 

Once the book's sections have been set up you are able to use the same technique to drag 
your chapters from the Hold chapters area into the correct section of the table of contents. 
If there are any chapters you are unsure about or want to make significant modifications to 
you can drag them back to the Hold chapters area so they wont appear on the books Table of 
Contents. 

Once chapters have been added to the Table of contents they are accessible when you click 
on the books title, either on your User page or on the front page of Booki. 
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16. 



COMMUNICATION 



When collaborating on a book, communication is a vital part of the process, whether working 
in a book sprint, taking your time on more long-term book generation, working locally in the 
same physical space or remotely online. These situations have different requirements and 
Booki includes tools to facilitate communication in each circumstance. 

REAL TIME EDIT NOTIFICATIONS 

When you have clicked on an edit link for a chapter and someone else enters the books 
overview screen your user name replaces the EDIT link in the Table of contents. This 
notification happens in real time, if you are looking at the overview screen when someone else 
clicks the edit link for one of its chapters you will see the edit button change to their user 
name. 

REAL TIME CHAT 

Upon entering a book's overview screen you will see a chat box for that book. The Chat is 
visible for the duration of the time you are editing the book, regardless of which chapter you 
are working on. Anyone else editing the book can also has the chat box and you are able to 
communicate with them by typing directly into the field under the the chat box. This feature 
is very useful for communication with remote participants in Book Sprints as well as any 
situation where contributors to are book are working on it simultaneously. 

Other information is also communicated through the Chat box. When a contributor enters the 
book editing screen a JOINED marker is displayed along with their name in the Chat box. So 
anyone already editing a book can see that someone else has joined them in editing mode and 
they can start communicating. 

The Chat box also displays an INFO marker and brief description when certain actions have 
taken place such as: 

• When a user saves a chapter 

• When a user creates a new chapter 

• When a user renames a chapter 

• When a user alters the status of a chapter 

• When a user creates a new section 

• When a book is being published 

when each of these activities has occurred, the INFO marker is displayed along with 
information stating who carried out the action, what the action was and what chapter or 
section was acted upon. 

SYSTEM LEVEL NOTIFICATION 



CHAPTER STATUS MARKERS 

In the Chapters tab of the book editing page, on the right hand side of each chapter bar there 
is a status marker for the chapter. 
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This can be manually altered depending on what stage the chapter is up to. Clicking on the 
marker reveals a drop-down list. Click on the list and select the status required for the 
chapter. The chapter's marker is changed to the new status. 

When working on a book that has been created from scratch, the default marker is not 
published. For a book that has been imported from another source, the default status for a 
chapter is imported even for new chapters that have been created from scratch 

WORK FLOW TOOLS 
BOOK PROGRESS INDICATORS 
LIVE USER STATUS LISTINGS 
BOOK NOTES 

Book Sprints, remote authoring and asynchronous authoring all have their own communication 
requirements. Harmonising these into one system is where FLOSS Manuals has done a lot of 
real world research and Booki will take the best of what we have learned. Booki included tools 
such as real time edit notifications to see who is editing what at this moment, a real time chat 
(web / IRC gateway), system level notifications, chapter status markers, book progress 
indicators, work flow tools, and live user status listings. 

collaborating, writing in solo, rapidly developing books, or taking your time - when you have 
worked with Booki you will never think of publishing the same way again. 
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17. 



PUBLISHING 



Once a book has been completed or finished to a satisfactory level it can be published. 
Publishing can be done to several different outputs - not just to standard print formats - each 
with it's own specific needs and uses. 

PUBLISHING FORMATS 

book formatted pdf - book(PDF) 

Used for the creation of printed books, the book(PDF) file can be uploaded to a print on 
demand service or even sent to a local printer for printing of a standard bound book. It can 
also be used for printing a single copy of a book from a domestic printer. 

newspaper formatted pdf - newspaper(PDF) 

This format is used for printing multicolumn texts to large scale newsprint. This can be useful 
for cheaply printing off books using a cheap print format and local printers. 

web formatted pdf - web(PDF) 

This type of production is to be read on screen. It can be added to a website, or downloaded 
for off-line viewing on a computer or any compatible device. 

epub 

epub is used for e-book publication, it generates and e-book using the open epub format. 
Which can be read using any compatible device, including computers with appropriate software 
as well as portable devices such as the Sony Reader and Apple's iPod Touch and iPhone. 

OpenOffice Rich Text format (.odt) 

This output can be opened and edited in OpenOffice.org, enabling extra customisations to be 
added as well as conversion to Microsoft's .doc format for exchange with 3rd parties who 
haven't heard of free software. 

HTML 

the HTML output can be embedded into any website, so an organisation is able to export a 
book to HTML and then embed it into their website. 

PUBLISHING A BOOK 

Once a book is ready from the Book page, click on the Publish tab. You can now set the 
publishing options for your book. 

Simple publication 



24 



• Enter a Title for your printed book - by default this is the title used within Booki but it 
can be changed if required. 

• Choose the output document type from the drop-down list. 

• Choose a licence for the book from the drop-down list. 

• Place a tick next to archive.org if you want a copy of your book sent there. 

• Click on Publish this book 

Booki will convert your book to the desired document type using espri and when finished will 
display a link to the generated document. 

Advanced options 

Clicking on Show advanced options reveals a range of extra settings that can be used to 
customise the output of your book. 

• If you have purchased an ISBN number for your book, you are able to add it using the 
advanced options. 

• A Table of Contents header can be added to your book. 

• You can set the size of your book, there is a pre-set list of sizes as well as the ability to 
enter custom Width, Height, Margins, Gutter, Columns and Column Margins. 

• You are able to set the style for you book using CSS mode. You can select either 
Server default or custom. With custom selected a text box is displayed where you are 
able to edit and modify the CSS used to generate your book. 

• At the bottom of the advanced options you can select Grey-scale for use when printing 
with only black and white such as printing to newsprint. 
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18. 



HOW WE WORK 



We are happy to extend our core team in time to include others that are enthusiastic about 
the project and can commit the time and energy. Currently we are a small team consisting of 
just the following members : 

Adam Hyde - Project Manager 
Aleksandar ErakoviAt - Progammer (Booki) 
Douglas Bagnall - Programmer (Espri, Objavi) 

There are several others involved such as Jan Gerber and Andy Cat. We also work closely with 
the Archive.org team on several issues including epub import and export of content directly to 
the Archive.org servers. 

The development of the FLOSS Manuals platform was really a process of experiencing first 
hand what is needed to develop Free Software manuals through two processes : 

1. Community and individual writing of documentation 

2. Book Sprints 

With FLOSS Manuals the team would work with the community and Book Sprint teams 
creating documentation and then discuss what works and doesn't work and extend the 
platform accordingly. Sometimes this was done with the assistance of project funding, and 
sometimes without. In all cases we preferred (and still do) utility over complicated design. KISS. 

We have now ceased work on the FLOSS Manuals platform to develop Booki and I think its fair 
to say that while the FM platform is fully functional and productive, we see it not as a 'finished' 
work but as a prototype and our primary feature-set design document for the current Booki 
development. 

This short pre-history also explains our preferred development methodology. Although we do 
have milestones and we have a pretty clear idea of what we want to build, much of the detail 
and new ideas are worked out in discussion in IRC. If you wish to contribute to the code base 
then the process of getting involved is more about engaging with the resources listed below 
and asking questions than it is about reading our (non-existing) design documentation. 

If you wish to help fix existing features please look at the Trac tickets. 

You can also read the section 'How You Can Help' if you wish to tackle implementing new 
features. 

The following are the main channels for communication and for getting the code. 

RESOURCES 

IRC : irc.freenode.net #fm-tech 

Email : http://lists.flossmanuals.net/listinfo.cgi/booki-dev-flossmanuals.net 

Code 

http://booki-dev.flossmanuals.net/git 

Here you will find the repositories for Booki, Objavi and Espri 

Trac 
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http://booki-dev.flossmanuals.net/ 
Primary Install 

http://www.booki.cc 

FLOSS Manuals 

http://www.flossmanuals.net 
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19. 



BUG REPORTING 



Bug Reporting - believe it or not, there are people out there that love bug reporting. If you are 
one of those people - we need you! 

HOW TO REPORT A BUG 

We use the a software called Trac' for reporting and managing bug reports. To contribute you 
must first create an account. You create an account on the Booki Bug Tracking (Trac) site at 
the following URL: 

http://booki-dev.flossmanuals.net/register 

Once you have done that you will need to open a new 'ticket'. In this instance a 'ticket' is just 
another word for 'bug report'. You can click on the 'New Ticket' link located at the top right of 
any page in Trac. If you don't see this link then you are probably not logged in. 

You will see a form with several fields : 

■ 

Here are some tips on what to put in each field: 

Summary - give a brief summary of the bug in no more than a dozen words. Keep it brief and 
descriptive. This in itself is an art! 

Reporter - this should automatically display your name and you should not alter this 
information. 

Description - describe the bug in much detail as possible. Be as specific as possible and 
provide information so that the developers can recreate the same error if possible. Don't 
worry about supplying too much information - put in here as much as you like. Additionally, if 
the bug has displayed an error message, copy and paste the entire message at the end of the 
description. 

Type - leave this as 'defect' (bug). 

Milestone - leave this as 'Bugs'. 

Keywords - add a few keywords to help people find all bugs related to a specific topic using 
the search system in Trac. You could use keywords like 'registration' if the bug was found 
during the registration process, 'editing' if the bug while discovered while editing a book etc. 
You can provide many keywords but make sure they are all separated by a comma 

Assign to - leave this blank (used by the developers) 

Priority - you can set this as you like, probably someone will come by later (the 'bug 
manager') and set the priority level again. 

Component - probably you will want to leave this set as 'Booki'. Only if you are testing Objavi 
(the publishing engine) will you need to set this as Objavi. 

Cc - leave this as it is displayed. If you wish to be informed of any changes to this bug report 
then add your Trac username and the end of this list preceded by a blank space. 
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Once all is filled out press 'Create ticket'. ..now pat yourself on the back and find more bugs to 
report! 



30 



Thanks for reading! 

Visit http://flossmanuals.net to make corrections or to find more manuals. 



